home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #2 / Amiga Plus CD - 1995 - No. 2.iso / pd / grafik / imagestudio / docs / imagestudio.txt < prev    next >
Text File  |  1995-04-11  |  69KB  |  2,042 lines
  1. ImageStudio, shareware image processing and conversion package for the
  2. Amiga.
  3.  
  4.    Copyright (C) 1994 Andy Dean, Graham Dean.
  5.  
  6.    Welcome to ImageStudio, shareware image processing and conversion
  7. package for the Amiga.
  8.  
  9.    This document applies to version 1.2.1, written on 7th December
  10. 1994, Copyright (C) 1994 Andy Dean, Graham Dean.
  11.  
  12. Introduction
  13. ************
  14.  
  15.    This chapter gives a brief introduction into the features offered by
  16. the program.
  17.  
  18. Copyright and Disclaimer
  19. ========================
  20.  
  21.    No guarantee of any kind is given that the programs described in
  22. this document are 100% reliable. You are using this material at your
  23. own risk. The authors *can not* be made responsible for any damage
  24. which is caused by using this program.
  25.  
  26.    The unregistered package is freeware, but still copyright by Andy
  27. Dean and Graham Dean. This means that you can copy it freely as long as
  28. you don't ask for a more than nominal copying fee.
  29.  
  30.    The registered version of the program *may not* be freely
  31. distributed.
  32.  
  33.    Permission is granted to include the unregistered package in
  34. Public-Domain collections, especially in the excellent Fred Fish Amiga
  35. Disk Library (including CD ROM versions of it). The distribution file
  36. may be uploaded to Bulletin Board Systems or FTP servers. If you want
  37. to distribute this program you must use the original distribution
  38. archive ImageStudio.lha.
  39.  
  40.    This program (or parts of it) may not be included or used in
  41. commercial programs unless by written permission from the authors.
  42.  
  43. Machine requirements
  44. ====================
  45.  
  46.    ImageStudio requires the following system to run:
  47.  
  48.    * Workbench 2.04 or above.
  49.  
  50.    * Around 1 megabyte of free memory.
  51.  
  52.    * Several megabytes of free hard disk space.
  53.  
  54.    If ImageStudio is run on an AGA machine (A1200 or A4000), it will
  55. use the new display modes and palette routines to improve the quality
  56. of the internal viewer images.
  57.  
  58. Brief description
  59. =================
  60.  
  61.    ImageStudio is written for the casual graphics user who wishes to
  62. convert or manipulate various graphics formats on a modest Amiga
  63. system. There are several commercial offerings available, however the
  64. casual user is paying a lot of money for many facilities and options
  65. they would probably never use.
  66.  
  67.    Bitmap graphics, by their nature, usually require large amounts of
  68. RAM. One of the main objectives of ImageStudio was to reduce this
  69. burden by utilising virtual memory - most users have more spare hard
  70. disk space than spare RAM.
  71.  
  72.    ImageStudio works with several buffers at any one time (dependant on
  73. how many levels of undo are specified), each of these buffers can hold
  74. either colour-mapped or 24-bit images. For a detailed description of
  75. colour-mapped and 24-bit images, See Image types.
  76.  
  77. List of features
  78. ================
  79.  
  80.    General:
  81.    * Full 24-bit image buffers, with optimizations for colour-mapped
  82.      (palette based) images.
  83.  
  84.    * Up to 100 levels of undo / redo.
  85.  
  86.    * User configurable virtual memory.
  87.  
  88.    * User saveable preferences.
  89.  
  90.    * Operations applicable to the whole image or a selected region.
  91.  
  92.    * Up to 256 greyshade preview window (with optional dither).
  93.  
  94.    * Zoom on preview window.
  95.  
  96.    * Internal / external viewers (external for 3rd party 24-bit
  97.      graphics cards).
  98.  
  99.    * Loading / saving / manipulating of AGA image formats (e.g. 256
  100.      colours, HAM8) on non-AGA machines.
  101.  
  102.    * Max image size of 32000 x 32000 (limited to 250 x 250 in the
  103.      unregistered version).
  104.  
  105.    * Copy / paste to / from the system clipboard.
  106.  
  107.    * Runs on all Workbench 2.04+ Amiga's - utilises AGA chipset if
  108.      available.
  109.  
  110.    * On disk AmigaGuide and ASCII text documentation. The registered
  111.      version also includes TeX `.dvi' and PostScript files.
  112.  
  113.    * Multi-level help error requesters.
  114.  
  115.    * Standard Workbench2 interface.
  116.  
  117.    * Public screen.
  118.  
  119.    * Requires no third party libraries or utilities.
  120.  
  121.    Import:
  122.    * IFF-ILBM formats (Standard palette based, HAM6, HAM8, extra
  123.      halfbright, ILBM24)
  124.  
  125.    * BMP
  126.  
  127.    * GIF (conforming to GIF87a)
  128.  
  129.    * JPEG (conforming to JFIF standard)
  130.  
  131.    * PCX
  132.  
  133.    * Targa
  134.  
  135.    * Any installed Amiga datatype (with Workbench 2.1+)
  136.  
  137.    Export:
  138.    * IFF-ILBM formats (Standard palette based, HAM6, HAM8, extra
  139.      halfbright, ILBM24)
  140.  
  141.    * BMP
  142.  
  143.    * EPS
  144.  
  145.    * GIF (conforming to GIF87a)
  146.  
  147.    * JPEG (conforming to JFIF standard)
  148.  
  149.    * PCX
  150.  
  151.    * Targa
  152.  
  153.    Colour Balance:
  154.    * All operations are available to the R,G,B components separately.
  155.  
  156.    * Brightness ( upto ±100%)
  157.  
  158.    * Contrast (non to full)
  159.  
  160.    * Gamma ( + and - )
  161.  
  162.    Convolution:
  163.    * Built in convolutions: Blur, Sharpen, Emboss, Raise, Edge detect.
  164.  
  165.    * User definable convolutions, load and save to disk.
  166.  
  167.    Effects:
  168.    * Built in effects: Dynamic range expansion, FlipX, FlipY, RollX,
  169.      RollY, Negative, Greyscale, Highlight, Shadow, Random, Pixelize,
  170.      Remove isolated pixels.
  171.  
  172.    Scale:
  173.    * Crop to selected region.
  174.  
  175.    * Increase / decrease scale by percentage or absolute image size.
  176.  
  177.    * Simple scale or colour averaged.
  178.  
  179.    Colour reduction:
  180.    * Increase colour mapped images to 24-bit.
  181.  
  182.    * Decrease number of colours in 24-bit or colour mapped images via
  183.      Heckbert median cut algorithm.
  184.  
  185.    * Dithers available for colour reduction: None, Floyd-Steinberg,
  186.      Burkes, Stucki, Sierra, Jarvis, Stevenson-Arce.
  187.  
  188.    Palette:
  189.    * Edit palette colours and ranges.
  190.  
  191.    * Save current palette.
  192.  
  193.    * Force palette onto current image, dithering if necessary (all
  194.      dithers available).
  195.  
  196. Shareware version
  197. =================
  198.  
  199.    To encourage users to register, the freely distributable version of
  200. ImageStudio is limited to loading in pictures upto 250x250 pixels. All
  201. other operations are available.
  202.  
  203.    For details on how to register, See How to register.
  204.  
  205. Starting ImageStudio
  206. ====================
  207.  
  208.    ImageStudio can be started from either the Workbench or CLI. From
  209. the Workbench it is simply a case of double-clicking on the icon.
  210. ImageStudio supports shift-clicking on a file to start the program with
  211. (see the Workbench manual for more information).
  212.  
  213.    To start ImageStudio from the CLI, simply type:
  214.  
  215.      run ImageStudio [filename]
  216.  
  217.    where `filename' is an optional file to load in at startup. The full
  218. range of tooltypes is supported, and can be appended to the CLI
  219. command. For example:
  220.  
  221.      run ImageStudio "SCREENNAME=Image2" "PREVIEWDITHER=YES" [filename]
  222.  
  223.    would start the program on a public screen named `Image2' with
  224. preview dithering on. See Tooltypes, for a full list of available
  225. tooltypes.
  226.  
  227. Configuring ImageStudio
  228. =======================
  229.  
  230.    In order to benefit from ImageStudio's virtual memory, it is
  231. recommended that the default location used for the storage of the
  232. temporary files is changed. The default location for the storage of
  233. these files is `T:' which is usually in RAM - we want to move this out
  234. onto harddisk.
  235.  
  236.    To do this, select `Prefs' from the `Project' menu and open up the
  237. prefs requester. In the `Temp. files' string gadget, type the new
  238. location for the temp files.
  239.  
  240.    It is suggested that a drawer be made on a harddisk partition with
  241. lots of space to store these files. For example, make a drawer in your
  242. `Work:' partition called `tmp', and change the `Temp. files' string
  243. gadget to read `Work:tmp'.
  244.  
  245. Tutorial
  246. ********
  247.  
  248.    This chapter introduces ImageStudio by way of a few tutorials
  249. demonstrating commonly performed operations.
  250.  
  251. Changing the image format
  252. =========================
  253.  
  254.    The simplest use of ImageStudio is just as a file format converter;
  255. See File formats, for details about the supported file formats.
  256.  
  257.    In this example we will change the image format of the
  258. `FW14B_250x250.gif' from GIF to IFF-ILBM.
  259.  
  260.   1. Load the file `FW14B_250x250.gif' from the `Pics' drawer. To do
  261.      this, select `Open' from the `Project' menu. When the file
  262.      requester opens, select the file and it will load into
  263.      ImageStudio. The greyscale preview will show the image.
  264.  
  265.   2. The Infobar at the bottom of the screen shows the current image
  266.      size and number of colours, as well as a fuelgauge showing
  267.      progress when applicable. The current co-ordinates of the pointer
  268.      are also shown when the preview window is active.
  269.  
  270.   3. Open the save requester. To do this, select `Save' from the
  271.      `Project' menu. A requester will open, containing (amongst other
  272.      things) possible save formats.
  273.  
  274.   4. Select the file format to save. To do this, click on `IFF-ILBM' in
  275.      the listview.
  276.  
  277.   5. Change the filename to avoid overwriting the original file. To do
  278.      this, type the new filename - `FW14B_250x250.ilbm' into the
  279.      `Filename' string gadget.
  280.  
  281.   6. Save out the file by clicking on the `Save' gadget.
  282.  
  283.    The file will now be saved out as a 256 colour IFF-ILBM onto the
  284. disk.
  285.  
  286.    Note:
  287.  
  288.    * ImageStudio automatically recognises the filetype of the incoming
  289.      image. It will use its internal loaders first, then trying
  290.      datatypes if running on Workbench 2.1+.
  291.  
  292.    * All time consuming operations show their progress in the Infobar's
  293.      fuelgauge and can be aborted by clicking on the `Abort' gadget.
  294.  
  295. Changing the number of colours
  296. ==============================
  297.  
  298.    Often it is necessary to reduce the number of colours in an image,
  299. either to reduce the file size or produce images compatible with
  300. non-AGA software.
  301.  
  302.    In this example we will reduce the number of colours in the
  303. `FW14B_250x250.gif' image from 256 colours to 16 colours.
  304.  
  305.   1. Load in the `FW14B_250x250.gif' from the `Pics' drawer, if it not
  306.      already loaded.
  307.  
  308.   2. Open the colours requester by selecting `Colours...' from the
  309.      `Process' menu.
  310.  
  311.   3. The gadgets in the requester will show that the image is a 256
  312.      colour colour-mapped image. Change the number of colours to 16 by
  313.      clicking on the cycle gadget or sliding the `No. of colours'
  314.      slider.
  315.  
  316.   4. Leave the `Colour choice' and `Dithering' gadgets for now.
  317.  
  318.   5. Click on `OK' to perform the operation.
  319.  
  320.   6. When the operation is complete, view the image with the internal
  321.      viewer by selecting `View' from the `View' menu. A 16 colour Lores
  322.      image will be displayed.
  323.  
  324.   7. Remove the internal viewer by clicking the right mouse button.
  325.  
  326.    The colour reduced image should contain all the main colours used in
  327. the original image (blue, yellow, red and grey), but should contain
  328. less shades of the colours. To give the impression of more colours,
  329. dithering can be used to mix pixels of the chosen colours. To perform
  330. the last operation with dithering:
  331.  
  332.   1. Undo the colour reduction operation to return to the original 256
  333.      colour image. To do this, select `Undo' from the `Edit' menu.
  334.  
  335.   2. Bring up the colours requester as before and select 16 colours.
  336.      Also change the `Dithering' gadget from `None' to
  337.      `Floyd-Steinberg'.
  338.  
  339.   3. Click on `OK' to perform the operation.
  340.  
  341.   4. View as before.
  342.  
  343.    The image will now perform more gradual changes to colour changes.
  344.  
  345. Changing the colour balance
  346. ===========================
  347.  
  348.    When receiving images from external sources (scanners, frame
  349. grabbers) it is ofter necessary to change to "colour balance" of the
  350. image. Frame grabbers, for example, may have too much `red' in the
  351. image.
  352.  
  353.    In this example we shall see the effects on the
  354. `ColourFace_200x250RED.ham6' image of altering the colour balance.
  355.  
  356.   1. Load in the `ColourFace_200x250RED.ham6' image from the `Pics'
  357.      drawer. As the file is in HAM6 format, it is turned into 24-bit
  358.      internally.
  359.  
  360.   2. View the image with the internal viewer. As the Amiga doesn't have
  361.      true 24-bit screenmodes, the internal viewer will approximate the
  362.      24-bit image with a HAM preview screen (HAM6 on ECS machines, HAM8
  363.      on AGA machines). It should be obvious from the viewer that the
  364.      image is too red.
  365.  
  366.   3. Open the balance floating palette if it is not already open. Do
  367.      this by selecting `Show balance' from the `Tools' menu.
  368.  
  369.   4. To remove some of the red component, make sure that we are only
  370.      dealing with the red component. To do this, make sure that only
  371.      the `Red' checkbox at the bottom of the floating palette is
  372.      checked.
  373.  
  374.   5. Reduce the brightness slider, by say 20%. The graph on the right
  375.      of the floating palette will reflect the change (see Show balance
  376.      for more details on the graph).
  377.  
  378.   6. View the image again, this time the image should have lost much of
  379.      its unnatural red tint.
  380.  
  381.    Brightness and contrast work in very much the same way as a TV set,
  382. but gamma may need some explanation.
  383.  
  384.    The printing an image out, it is usual for light colours to be
  385. resolved well and dark colours to be reduced to a dark mush. It is
  386. therefore preferable to have some way boost the brightness of the
  387. mid-dark colours whilst still leaving the very light colours light and
  388. the very dark colours dark. Gamma is the operator to perform this
  389. change. By applying a small amount of positive gamma, a much better
  390. balanced image can be produced for printing out.
  391.  
  392.    See Show balance, for more information on the balance floating
  393. palette.
  394.  
  395. Applying an effect
  396. ==================
  397.  
  398.    ImageStudio has many built in effects for performing commonly used
  399. operations.
  400.  
  401.    This example will remove some noise from a region of
  402. `HappyFace_240x250.bmp', a simulated scanned image.
  403.  
  404.   1. Load in the `HappyFace_240x250.bmp' image from the `Pics' drawer.
  405.  
  406.   2. The image represents what may happen if you hand scan an image
  407.      into the computer - lots of "noise".
  408.  
  409.   3. Open the effects floating palette if it is not already open. Do
  410.      this by selecting `Show effects' from the `Tools' menu.
  411.  
  412.   4. Select `Remove isolated pixels' in the listview of the floating
  413.      palette. If you clicked on the `Apply' button now, the effect
  414.      would be applied to the whole image. To compare the image before
  415.      and after the effect, we'll only apply the effect to the left hand
  416.      side of the image.
  417.  
  418.   5. Open the `Region co-ords' requester by selecting `Region
  419.      co-ords...' from the `Edit' menu. To select the left hand side of
  420.      the image, set the following values in the gadgets: Min x = 0, Min
  421.      y = 0, Width = 120, Height = 250. Make sure that the radio button
  422.      on the left of the requester shows that the Width / Height are
  423.      being used, not the Max values; click on `Ok'.
  424.  
  425.   6. A region of "crawling ants" will show the selected region.
  426.  
  427.   7. Click on `Apply' of the effects floating palette. The `Remove
  428.      isolated pixels' effect will be applied to the selected region.
  429.  
  430.   8. The left of the image will have had a lot of the noise
  431.      automatically removed. Clear the selected region by clicking in
  432.      the preview window.
  433.  
  434.    Note:
  435.    * Not all effects can be applied to regions and whole images. See
  436.      Show effects, for a comprehensive description of all the effects.
  437.  
  438.    See Show effects, for more information on the effects floating
  439. palette.
  440.  
  441. Applying a convolution
  442. ======================
  443.  
  444.    Convolution is a powerful image processing tool, ImageStudio allows
  445. the user to define their own convolution filters.
  446.  
  447.    This example will apply a `Texture' filter to the
  448. `CheetahFace_250x200.ilbm' image.
  449.  
  450.   1. Load in the `CheetahFace_250x200.ilbm' image from the `Pics'
  451.      drawer.
  452.  
  453.   2. The `CheetahFace_250x200.ilbm' image is a 32 colour colour-mapped
  454.      image and convolution only works in 24-bit (see Show convolves for
  455.      information on how convolves actually work). We therefore need to
  456.      turn the image into a 24-bit.
  457.  
  458.   3. Open the colours requester and click on the `16 million colours'
  459.      radio button on the left. Click on `OK'. The image in converted
  460.      into 24-bit.
  461.  
  462.   4. Open the convolves floating palette if it is not already open. Do
  463.      this by selecting `Show convolves' from the `Tools' menu.
  464.  
  465.   5. There should be 1 user convolve in the list - `Texture'. Click on
  466.      it.
  467.  
  468.   6. Apply the convolution filter to the image by clicking on `Apply'
  469.      at the bottom of the floating palette.
  470.  
  471.   7. After the filter has been applied, you could view the result with
  472.      the internal viewer in 24-bit, but for a clearer image we'll
  473.      convert it back to 32 colours.
  474.  
  475.   8. Open the colours requester, select `No. colours' = 32 and `Dither'
  476.      = `None'. Click on `OK'.
  477.  
  478.   9. Now view the 32 colour image with the internal viewer. The image
  479.      now has a rough paper(?) texture applied to it.
  480.  
  481.    Note:
  482.  
  483.    * There are many commonly used convolution filters available, it is
  484.      up to the user to build a collection suitable filters for their
  485.      own use. If you find any useful or interesting ones, you could
  486.      send them to the authors (see The authors) for inclusion into the
  487.      distribution.
  488.  
  489.    See Show convolves, for more information on the convolves floating
  490. palette.
  491.  
  492. Scaling the image
  493. =================
  494.  
  495.    In this example we will scale the `CheetahFace_250x200.ilbm' image
  496. from 250 x 200 pixels down to 80 x 40 (icon size).
  497.  
  498.   1. Load in the `CheetahFace_250x200.ilbm' image from the `Pics'
  499.      drawer.
  500.  
  501.   2. Open the scale requester by selecting `Scale...' in the `Process'
  502.      menu.
  503.  
  504.   3. Set the `Width' = 80 and `Height' = 40. Click on `OK'.
  505.  
  506.   4. The image is re-scaled to that of an icon.
  507.  
  508.    The finish the creation of the icon, we can load it into Commodore's
  509. `IconEdit' program. Both ImageStudio and IconEdit support the
  510. clipboard, so we can copy the image into the clipboard from ImageStudio
  511. and paste it into IconEdit.
  512.  
  513.   1. Copy the image to the clipboard by selected `Copy' in the `Edit'
  514.      menu of ImageStudio.
  515.  
  516.   2. Run IconEdit from the `Tools' drawer of your system partition.
  517.  
  518.   3. Select `Paste' from IconEdit's `Edit' menu. The image will be
  519.      copied into IconEdit for final editing.
  520.  
  521. Menu options
  522. ************
  523.  
  524.    This chapter describes ImageStudio's menu options in detail.
  525.  
  526.    Selecting a main menu from the list below will give a list of
  527. sub-menu options.
  528.  
  529. Project
  530. =======
  531.  
  532.    Select the submenu you wish to investigate.
  533.  
  534. Open
  535. ----
  536.  
  537.    Keyboard shortcut - `Amiga - O'
  538.  
  539.    This is how the user loads in an image into the program.
  540.  
  541.    A file requester will appear, through which the user can select a
  542. file to open. Upon selecting a file, ImageStudio will test the file
  543. against its known file formats - loading the file if the image type is
  544. recognised. If the image format is not recognised, an error will be
  545. shown.
  546.  
  547.    In most cases the image will load directly into ImageStudio; however
  548. in the case of HAM6 and HAM8 formats the image is converted into 24-bit
  549. data as it is loaded in, as ImageStudio cannot work directly on HAM
  550. images. For a detailed description of colour-mapped and 24-bit images,
  551. See Image types.
  552.  
  553. Save
  554. ----
  555.  
  556.    Keyboard shortcut - `Amiga - S'
  557.  
  558.    The save requester allows the user to choose the filename for the
  559. saved image as well as the image's format.
  560.  
  561.    To change the filename, either click in the string gadget and edit
  562. the filename directly or click on the `Choose...' gadget to select the
  563. filename with a file requester.
  564.  
  565.    To change the image format of the file to be saved, click in the
  566. listview on the appropriate format. Depending on the format selected,
  567. depends on whether the `Options...' and `Screen...' buttons remain
  568. unghosted. Some formats (e.g. IFF-ILBM) have further options available
  569. by clicking on the `Options...' button. The `Screen...' button can be
  570. clicked on to change the screenmode of the saved image (only used with
  571. IFF-ILBM images).
  572.  
  573.    When the user has selected the filename and the image format, the
  574. file can be saved by clicking on `OK' or no action can be performed by
  575. clicking on `Cancel'. If the currently selected filename already
  576. exists, the user will be warned that they are about to overwrite it.
  577.  
  578. Screen mode
  579. -----------
  580.  
  581.    The user may select the current screen's resolution and number of
  582. colours.
  583.  
  584.    The screenmode requester allows the user to change the properties of
  585. the current screen. Click on the desired screenmode as well as the
  586. size, number of colours and overscan settings. To bring the changes
  587. into effect, click on `OK' else to perform no action click on `Cancel'.
  588.  
  589.    See Known bugs, for information about a known problem with this
  590. operation.
  591.  
  592. Prefs
  593. -----
  594.  
  595.    This is how the user may configure the program to their own needs
  596. with the prefs requester.
  597.  
  598. Temp files
  599.      This is the drawer where ImageStudio will store its virtual memory
  600.      temporary files. By default, this is the `T:' drawer which usually
  601.      lies in the ram disk. Temp files kept in RAM will take up a lot of
  602.      memory, so it is recommended that they be moved out to somewhere
  603.      on hard disk. For example: using the Workbench, create a drawer
  604.      called `tmp' in the system partition of your hard drive. Then
  605.      change the temp files string in the prefs requester to `sys:tmp'.
  606.      ImageStudio will now store all its temporary files in this drawer.
  607.  
  608. Convolves
  609.      This is the drawer where ImageStudio will search for user-defined
  610.      convolution filters on startup. By default this is the `Convolves'
  611.      drawer in the same drawer as the program, but the user may change
  612.      this to an alternative location if they desire.
  613.  
  614. Palettes
  615.      This is the drawer where ImageStudio will search for extra palette
  616.      colour files when the palette requester is opened. By default this
  617.      is the `Palettes' drawer in the same drawer as the program, but
  618.      the user may change this to an alternative location if they desire.
  619.  
  620. Screen name
  621.      This is the name of the public screen on which ImageStudio is
  622.      running. By default this is `IMAGESTUDIO' but could be changed if
  623.      the user wishes to run 2 copies of the program on different
  624.      screens. Note: The new public screen name comes into effect either
  625.      when the program is restarted or if the user changes the
  626.      screenmode with the `Screen mode' requester (see Screen mode).
  627.  
  628. External viewer
  629.      This is the CLI command that ImageStudio will execute when the
  630.      user chooses `External viewer' from the `View' menu (see External
  631.      viewer). The string is in the form you would start the viewer from
  632.      a Shell or CLI, with a `%s' placed where the filename should be
  633.      placed.
  634.  
  635.      The default string of
  636.           run sys:Utilities/VT <NIL: >NIL: %s
  637.      would run Thomas Krehbiel's ViewTek program to view the image. If
  638.      you own one of the 3rd party 24-bit graphics cards supported by
  639.      ViewTek the image would be displayed on that.
  640.  
  641.      Note:
  642.  
  643.      It is not essential to start the program with `run', but this
  644.      allows ImageStudio to continue to run even with the viewer active.
  645.      The `<NIL: >NIL:' are also not essential, but will stop any text
  646.      output windows opening from the viewer.
  647.  
  648. Page size
  649.      This is the maximum amount (in kilobytes) of the virtual memory
  650.      temporary files to be loaded into RAM at any time. The larger you
  651.      make this value, the less disk accessing is performed but the more
  652.      data is transferred in a disk access. Use 50k for a minimal set
  653.      up, 100k for a more reasonable value.
  654.  
  655. Clip unit
  656.      This is the clipboard number to use. Set to 0 for normal use, any
  657.      number 1-255 if you wish to use a custom clipboard.
  658.  
  659. No. undo buffers
  660.      This is the maximum number of undo / redo steps possible. The
  661.      higher the number, to more disk space (not RAM) is used. Bear in
  662.      mind that when dealing with large 24-bit images each undo buffer
  663.      can be several megabytes - a value around 4 will suffice for most
  664.      users. Note: a change to this value will not come into effect
  665.      until the next time ImageStudio is run.
  666.  
  667. Save window positions
  668.      Check this box if you wish the current window layout to be the
  669.      default at startup.
  670.  
  671. Save screen mode
  672.      Check this box if you want the current screenmode to be the
  673.      default at startup.
  674.  
  675. Preview dither
  676.      When using a screen with few colours, checking this box enables
  677.      dithering to be used on the preview window to give the impression
  678.      of more colours. This slows down the preview redraw slightly.
  679.  
  680. Splash window
  681.      Checking this box causes the about requester to be shown at
  682.      startup.
  683.  
  684.    In order to save these preferences, click on `Save'. The information
  685. is written to the program's icon in the form of tooltypes; the user
  686. should have no need to alter these tooltypes directly.
  687.  
  688.    The current preferences can be used without saving by clicking on
  689. `Use' or ignored by clicking on `Cancel'.
  690.  
  691. Info
  692. ----
  693.  
  694.    This brings up an information requester containing memory and file
  695. usage information.
  696.  
  697.    The `Memory' figures are the amount of RAM used by the buffers, the
  698. `VMem' figures are the amount of disk space used by the virtual memory.
  699.  
  700.    At the bottom of the requester the amount of free RAM is shown.
  701.  
  702. About
  703. -----
  704.  
  705.    This brings up a small requester containing information about the
  706. program version number and the user name (only in registered version).
  707.  
  708. Quit
  709. ----
  710.  
  711.    This quits the program. If any changes remain unsaved, the user is
  712. warned before the program quits.
  713.  
  714. Edit
  715. ====
  716.  
  717.    Select the submenu you wish to investigate.
  718.  
  719. Undo
  720. ----
  721.  
  722.    Keyboard shortcut - `Amiga - U'
  723.  
  724.    Undos last operation.
  725.  
  726.    The maximum number of undos is set in the preferences requester, See
  727. Prefs.
  728.  
  729. Redo
  730. ----
  731.  
  732.    Keyboard shortcut - `Amiga - R'
  733.  
  734.    Redos last undo.
  735.  
  736.    The maximum number of redos is set in the preferences requester, See
  737. Prefs.
  738.  
  739. Copy
  740. ----
  741.  
  742.    Keyboard shortcut - `Amiga - C'
  743.  
  744.    Copies the current image to the clipboard.
  745.  
  746.    Once the image has been copied to the clipboard it can be used by
  747. any other program that supports the Amiga clipboard.
  748.  
  749. Paste
  750. -----
  751.  
  752.    Keyboard shortcut - `Amiga - V'
  753.  
  754.    Reads in image from the clipboard.
  755.  
  756. Region co-ords
  757. --------------
  758.  
  759.    Keyboard shortcut - `Amiga - D'
  760.  
  761.    Allows the user to select a region by typing the co-ordinates.
  762.  
  763.    The region co-ords requester allow the user to specify the selected
  764. region by either typing in the co-ordinates of the minimum and maximum
  765. corners of the rectangle or the minimum co-ordinates and the
  766. rectangle's width and height. A radio button on the left of the
  767. requester shows whether the maximum co-ords or the width and height are
  768. to be used to select the region.
  769.  
  770.    If there is already a selected region, these values are copied into
  771. the requester when it is opened.
  772.  
  773. Region deselect
  774. ---------------
  775.  
  776.    Removes any selected region from the preview window.
  777.  
  778.    As well as this menu item, the region can be cleared by simply
  779. clicking in the preview window.
  780.  
  781. Select all
  782. ----------
  783.  
  784.    Keyboard shortcut - `Amiga - A'
  785.  
  786.    Makes the selected region the whole of the displayed image in the
  787. preview window.
  788.  
  789.    Note:
  790.  
  791.    If the user has zoomed in on a region of the image (see Zoom in),
  792. `Select all' will not select the whole image but just the displayed
  793. image in the preview window.
  794.  
  795. View
  796. ====
  797.  
  798.    Select the submenu you wish to investigate.
  799.  
  800. Full image
  801. ----------
  802.  
  803.    Keyboard shortcut - `Amiga - F'
  804.  
  805.    Displays the whole image in the preview window.
  806.  
  807. Zoom in
  808. -------
  809.  
  810.    Keyboard shortcut - `Amiga - <'
  811.  
  812.    Zooms in to make the currently selected region fill the preview
  813. window.
  814.  
  815. Zoom out
  816. --------
  817.  
  818.    Keyboard shortcut - `Amiga - >'
  819.  
  820.    Zooms out by a factor of 3 times.
  821.  
  822. Internal viewer
  823. ---------------
  824.  
  825.    Keyboard shortcut - `Amiga - I'
  826.  
  827.    Views the current image with the internal viewer.
  828.  
  829.    If the image is colour-mapped, the viewer will try and open a screen
  830. with the same number of colours as the image. Under the AGA graphics
  831. chipset this should always be possible (providing there is enough free
  832. CHIP RAM), however under the ECS chipset it is impossible to open up
  833. screens of greater than 5 bitplanes. Viewing a 256 colour image, for
  834. example, on a ECS machine is not possible directly.
  835.  
  836.    If the image originated as an IFF-ILBM, the viewer screen will try
  837. and open up in the same screen mode as the image. If this is not
  838. possible, the user may change to a more suitable screenmode with the
  839. `View screenmode' menu option, See View screenmode.
  840.  
  841.    Viewing 24-bit images is done by using the HAM screenmodes (HAM6
  842. under ECS, HAM8 under AGA) to approximate the 24-bit image. In order to
  843. keep the viewer reasonably fast, the HAM image sometimes suffers from
  844. `colour fringing' as the approximation is relatively crude (especially
  845. under ECS).
  846.  
  847.    If the internal viewer won't display the current image, check the
  848. following:
  849.  
  850.   1. If the image was loaded in as an IFF-ILBM, the saved screenmode
  851.      may not be supported by your machine. For example, the screenmode
  852.      may be `Productivity' and your machine doesn't have a multiscan
  853.      monitor. Simply change the screenmode to one your machine does
  854.      support - e.g.  `Hires Laced'
  855.  
  856.   2. A colour-mapped image contains more colours than it is possible to
  857.      show on a ECS machine. Either reduce the number of colours in the
  858.      image to a number that can be displayed or increase the number of
  859.      colours to 16 million (see Colours) and use the internal viewer to
  860.      display an approximation in a HAM screen.
  861.  
  862.   3. Make sure you have enough CHIP RAM free to open the screen. Large
  863.      256 colour and 16 million colours images take lots of CHIP RAM.
  864.  
  865.    To stop the viewer at any time, press the right mouse button or
  866. click on `Abort' in the infobar.
  867.  
  868. View screenmode
  869. ---------------
  870.  
  871.    This allows the user to set the screenmode of the image, and
  872. therefore of the internal viewer.
  873.  
  874.    Click on the desired screenmode for the image in the screenmode
  875. requester. The current screenmode is highlighted in the listview.
  876.  
  877. External viewer
  878. ---------------
  879.  
  880.    Uses an external viewer program to view the image.
  881.  
  882.    This calls up the external viewer program to view the current image.
  883. If a 3rd party 24-bit graphics card is installed, a viewer can be used
  884. to view the image on that.
  885.  
  886.    To specify the external viewer to use, See Prefs.
  887.  
  888. Process
  889. =======
  890.  
  891.    Select the submenu you wish to investigate.
  892.  
  893. Crop
  894. ----
  895.  
  896.    Crops the current image to the selected region.
  897.  
  898.    This reduces the image to only that which is in the selected region.
  899. A region must be selected in order for this operation to work.
  900.  
  901. Scale
  902. -----
  903.  
  904.    Reduces / increases the size of the image.
  905.  
  906.    The scale requester allows the user to change the image's width /
  907. height by either selecting the absolute size of the new image or the
  908. percentage by which to scale. A radio gadget to the left shows which
  909. operation will be performed.
  910.  
  911.    The percentage value may also be changed by sliding the width and
  912. height sliders to achieve the desired final size; divide and multiply
  913. by 2 buttons are provided to quickly scale the image by common amounts.
  914.  
  915.    Finally, two methods of scaling are supported: fast and colour
  916. average. Fast scaling works with both colour-mapped and 24-bit images
  917. and produces results adequate for most needs. If the image is to be
  918. scaled up by a large amount the image may become very `blocky' and if
  919. the image is scaled down a large amount, information in the image may
  920. be lost. To reduce this, colour average scaling is available on 24-bit
  921. images which reduces blockiness when increasing the scale and reduces
  922. information loss when reducing the scale. Colour average rescale can
  923. take significantly longer than a fast rescale.
  924.  
  925. Colours
  926. -------
  927.  
  928.    Allows increasing / decreasing of the number of colours in the
  929. image, with various dithers.
  930.  
  931.    The colours requester allows the user control over the number of
  932. colours in the image. A radio button on the left hand side shows
  933. whether the current image is colour-mapped or 24-bit.
  934.  
  935.    To increase the number of colours in a colour-mapped image, simply
  936. select the new number of colours with the top cycle gadget or the `No.
  937. colours' slider. Although the number of colours need not be a power of
  938. 2 (2, 4, 8, 16, 32, 64, 128 or 256), internally the number will be
  939. rounded up to the nearest power of 2. If, for example, a 16 colour
  940. picture was increased to 20 colours then the image would become a 32
  941. colour image.
  942.  
  943.    Colour-mapped images can also be turned into 24-bit images by
  944. clicking on the `16 million colours' radio button on the left hand side
  945. of the requester. This is useful if the user wishes to perform an
  946. operation on a colour-mapped image that can only be performed on a
  947. 24-bit image. The resultant 24-bit image can then be turned back into a
  948. colour-mapped image after the operation is complete.
  949.  
  950.    To reduce the number of colours in an image, the same process is
  951. followed as above with a few differences. Whereas increasing the number
  952. of colours in an image does not lose any image information, it is
  953. enevitable that reducing the number of colours must lose some of the
  954. colour information. In order to help reduce the effect of this, two
  955. other aids are used: dithering and palette choice.
  956.  
  957.    The result of colour reduction is always a colour-mapped image. The
  958. user may select the number of colours in the final image with the top
  959. cycle gadget or the `No. colours' slider. Again, although the number of
  960. colours need not be a power of  2 (2, 4, 8, 16, 32, 64, 128 or 256),
  961. internally the number will be rounded up to the nearest power of 2.
  962. This though can be useful, as the user may want to reduce a 24-bit
  963. image down to 30 colours - leaving 2 spare for his / her own use.
  964.  
  965.    In order to give the impression of more colours in the reduced
  966. colour image, dithering can be employed to smoothly distribute colours
  967. over areas of high colour change. `Floyd-Steinberg' is the most common
  968. method and works well in most cases. For larger images, better contrast
  969. can be obtained by using a more computationally intensive dither
  970. (`Burkes', `Stucki', `Sierra', `Jarvis') and for the user with large
  971. images and lots of time to spare, `Stevenson-Arce'. Again, there is no
  972. hard and fast rule which method of dithering is best; if you're not
  973. happy with the result, try a different method.
  974.  
  975. Palette
  976. -------
  977.  
  978.    Allows the saving of the current palette and loading of new palette
  979. onto the current image.
  980.  
  981.    Palettes can either be loaded, saved and edited in ImageStudio:
  982.  
  983. Palette load
  984.      This is used to force a palette onto an image. The requester
  985.      allows the user to choose the palette to load and any dithering to
  986.      be applied to the image, See Colours. Various sample palettes are
  987.      given with the distribution to map the image to the Workbench
  988.      colours or a general purpose palette. New palettes can be
  989.      generated with any popular paint package(1).
  990.  
  991. Palette save
  992.      Saves the current palette out to the filename chosen by the user
  993.      in the requester. The palette file is compatible with the popular
  994.      paint packages. This option has no relevance for 24-bit images, as
  995.      they have no palette.
  996.  
  997. Palette edit
  998.      This brings up the palette edit requester. Here the user may edit
  999.      each colour individually or move the colours around with the
  1000.      `Copy' and `Swap' operations. Colour ranges can be created and
  1001.      ranges may be sorted into order of increasing or decreasing
  1002.      luminosity.
  1003.  
  1004.      To edit a colour, simply click on the colour in the scrolling
  1005.      viewer and edit the R,G,B or H,S,V colour values (see Colour
  1006.      representations).
  1007.  
  1008.      To copy or swap two colours, click on the first one in the
  1009.      scrolling viewer then click on either `Copy' or `Swap'. The
  1010.      pointer will change to a "To" pointer to allow you to click on
  1011.      another colour to swap or copy to.
  1012.  
  1013.      To create a colour spread, alter one colour to be the start of the
  1014.      spread and alter another colour to be the end of the spread.
  1015.      Clicking on the first colour, then on `Spread', the on the end
  1016.      colour will cause a smooth transition of colours between the start
  1017.      and end colours.
  1018.  
  1019.      Sorting the colours is like a colour spread, only no colour values
  1020.      are actually changed. Simply click on the start of the sort,
  1021.      followed by either of the `Sort' buttons and finally on the end
  1022.      colour. The colours between these values will be sorted into
  1023.      either an increasing or decreasing order of luminosity.
  1024.  
  1025.      Finally, to apply the new colour palette to the image click on
  1026.      `OK'. To remap the image to the new palette (swap the old colours
  1027.      with their nearest match in the new palette), click on `Remap'.
  1028.  
  1029.      Whilst changing the colours in the scrolling viewer, the colours
  1030.      in the preview window will change. *This is not a representation
  1031.      of what is happening to the image!*. See Common questions, for a
  1032.      full explanation as to this effect.
  1033.  
  1034.    ---------- Footnotes ----------
  1035.  
  1036.    (1)  Except Brilliance, which seems to save all 384 colours of its
  1037. palette.
  1038.  
  1039. Convolve presets
  1040. ----------------
  1041.  
  1042.    Various commonly used convolution effects.
  1043.  
  1044.    Convolution effects are a very powerful method of processing 24-bit
  1045. images. See below for more details on how they work.
  1046.  
  1047.    Some popular convolution effects are built in to ImageStudio:
  1048.  
  1049. Blur low
  1050.      Slightly blurs the image. The convolution matrix is:
  1051.           0  0  0  0  0
  1052.           0  0  1  0  0
  1053.           0  1  2  1  0
  1054.           0  0  1  0  0
  1055.           0  0  0  0  0
  1056.           Div = 6, Bias = 0
  1057.  
  1058. Blur high
  1059.      Blurs the image quite a lot. The convolution matrix is:
  1060.           0  1  1  1  0
  1061.           1  1  1  1  1
  1062.           1  1  1  1  1
  1063.           1  1  1  1  1
  1064.           0  1  1  1  0
  1065.           Div = 21, Bias = 0
  1066.  
  1067. Sharpen low
  1068.      Slightly sharpens the detail in the image. The convolution matrix
  1069.      is:
  1070.           0  0  0  0  0
  1071.           0  0 -1  0  0
  1072.           0 -1 10 -1  0
  1073.           0  0 -1  0  0
  1074.           0  0  0  0  0
  1075.           Div = 6, Bias = 0
  1076.  
  1077. Sharpen high
  1078.      Sharpens the detail in the image quite a lot. The convolution
  1079.      matrix is:
  1080.           0  0  0  0  0
  1081.           0 -2 -2 -2  0
  1082.           0 -2 18 -2  0
  1083.           0 -2 -2 -2  0
  1084.           0  0  0  0  0
  1085.           Div = 2, Bias = 0
  1086.  
  1087. Emboss low
  1088.      Gives the image a `lowered' look. The convolution matrix is:
  1089.           0  0  0  0  0
  1090.           0  0  0  0  0
  1091.           0  0  1  0  0
  1092.           0  0  0 -1  0
  1093.           0  0  0  0  0
  1094.           Div = 1, Bias = 204
  1095.  
  1096. Emboss high
  1097.      Gives the image a greater `lowered' look. The convolution matrix
  1098.      is:
  1099.           0  0  0  0  0
  1100.           0  0  0  0  0
  1101.           0  0  1  1  0
  1102.           0  0  1  0 -1
  1103.           0  0  0 -1 -1
  1104.           Div = 1, Bias = 204
  1105.  
  1106. Raise low
  1107.      Gives the image a `raised' look. The convolution matrix is:
  1108.           0  0  0  0  0
  1109.           0  0  0  0  0
  1110.           0  0  2  0  0
  1111.           0  0  0 -1  0
  1112.           0  0  0  0  0
  1113.           Div = 1, Bias = 0
  1114.  
  1115. Raise high
  1116.      Gives the image a greater `raised' look. The convolution matrix is:
  1117.           0  0  0  0  0
  1118.           0  0  0  0  0
  1119.           0  0  2  1  0
  1120.           0  0  1  0 -1
  1121.           0  0  0 -1 -2
  1122.           Div = 1, Bias = 0
  1123.  
  1124. Edge detect
  1125.      Replaces areas of high colour change to thin edges. The
  1126.      convolution matrix is:
  1127.           0  0  0  0  0
  1128.           0  0 -1  0  0
  1129.           0 -1  4 -1  0
  1130.           0  0 -1  0  0
  1131.           0  0  0  0  0
  1132.           Div = 1, Bias = 0
  1133.  
  1134.    What follows is a quick description of convolution, it is not
  1135. necessary to understand this to use the filters.
  1136.  
  1137.    It is convenient think of the convolution filter as an array of
  1138. numbers that "slides" over the image a pixel at a time. To find the new
  1139. colour value of the pixel at the centre of the filter, multiply the
  1140. filter values by the values of the colours under the array then divide
  1141. the result by the `Div' value, then add the `Bias' value.
  1142.  
  1143.    If we take the example of 3 x 3 `blur low' filter being applied to
  1144. the pixels below:
  1145.  
  1146.      filter                  pixels
  1147.      
  1148.      0 1 0                   a b c
  1149.      1 2 1  convolved with   d e f   gives:
  1150.      0 1 0                   g h i
  1151.  
  1152.    ((0 x a) + (1 x b) + (0 x c) + (1 x d) + (2 x e) + (1 x f) + (0 x g)
  1153. + (1 x h) + (0 x i)) / Div + Bias
  1154.  
  1155.    which would be applied to the new pixel in the position of the `e'
  1156. pixel.
  1157.  
  1158.    Although the pixels shown above are shown as `a', `b' etc... they
  1159. are actually the 3 red, green and blue values that comprise the colour.
  1160.  
  1161.    Examples:
  1162.  
  1163.   1.      0 0 0
  1164.           0 1 0
  1165.           0 0 0
  1166.           Div = 3, Bias = 0
  1167.      would make each pixel one third of its original brightness.
  1168.  
  1169.   2.      0 0 0
  1170.           0 0 0
  1171.           0 1 0
  1172.           Div = 1, Bias = 0
  1173.      would move each pixel up by one.
  1174.  
  1175.   3.      0 0 0
  1176.           0 1 0
  1177.           0 0 0
  1178.           Div = 1, Bias = 50
  1179.      would add 50 onto each of the red, green, blue components of the
  1180.      centre pixel.
  1181.  
  1182.    Note:
  1183.  
  1184.    * The red, green, blue components of a pixel can have values in the
  1185.      range 0 to 255. If a convolution value is greater than 255 it is
  1186.      made equal to 255. Similarly if a convolution value is less than 0
  1187.      it is made equal to 0.
  1188.  
  1189.    * ImageStudio has optimized routines for 1x1, 3x3 and 5x5 filters.
  1190.      If the program detects that only values in a 3x3 filter are being
  1191.      used, only calculations for a 3x3 filter are performed.
  1192.  
  1193. Tools
  1194. =====
  1195.  
  1196.    Select the submenu you wish to investigate.
  1197.  
  1198. Show balance
  1199. ------------
  1200.  
  1201.    Opens / closes the balance floating palette.
  1202.  
  1203.    The balance floating palette is used to control the brightness,
  1204. contrast and gamma of the current image. On 24-bit images, the colour
  1205. balance can be altered on selected regions as well as the whole image
  1206. whereas colour-mapped images only allow alterations to the whole image.
  1207.  
  1208.    The colour balance effects are usually applied to all the red /
  1209. green / blue components simultaneously, but each component can be
  1210. altered individually by checking the `Red', `Green' or `Blue'
  1211. checkboxes at the bottom of the floating palette.
  1212.  
  1213.    The effect of changing either the brightness, contrast or gamma can
  1214. be seen in the graph on the right hand side of the floating palette.
  1215. The graph shows the input RGB component along the X-axis and the output
  1216. RGB component along the Y-axis.
  1217.  
  1218.               output
  1219.       Light RGB ^
  1220.                 |
  1221.                 |
  1222.                 |
  1223.                 |
  1224.                 |
  1225.        Dark RGB |
  1226.                 +-------> input
  1227.             Dark RGB  Light RGB
  1228.  
  1229.    No operation is shown therefore with a straight diagonal line - the
  1230. input value is mapped to the same output value.
  1231.  
  1232.               output
  1233.                 ^
  1234.                 |     /
  1235.                x|____/
  1236.                 |   /|
  1237.                 |  / |
  1238.                 | /  |
  1239.                 |/   |
  1240.                 +-------> input
  1241.                      x
  1242.  
  1243. Brightness
  1244.      Altering the brightness is achieved by mutliplying up / down the
  1245.      RGB components by the specified amount. The range of the slider is
  1246.      from -100% (everything becomes black) to +100% (everything is
  1247.      twice as bright).
  1248.  
  1249. Contrast
  1250.      Altering the contrast forces dark colours darker and light colours
  1251.      lighter. The range of the slider is from -100% (everything becomes
  1252.      mid grey) to +100% (RGB components are either on/off).
  1253.  
  1254.      Note: 100% contrast on a colour image doesn't produce a black and
  1255.      white image as may be expected. As each RGB component is treated
  1256.      individually, it leaves you with an 8 colour image - the 8 colours
  1257.      being composed of combinations of the RGB components as below:
  1258.  
  1259.     Black
  1260.           0% Red, 0% Green, 0% Blue
  1261.  
  1262.     Red
  1263.           100% Red, 0% Green, 0% Blue
  1264.  
  1265.     Green
  1266.           0% Red, 100% Green, 0% Blue
  1267.  
  1268.     Blue
  1269.           0% Red, 0% Green, 100% Blue
  1270.  
  1271.     Yellow
  1272.           100% Red, 100% Green, 0% Blue
  1273.  
  1274.     Magenta
  1275.           100% Red, 0% Green, 100% Blue
  1276.  
  1277.     Cyan
  1278.           0% Red, 100% Green, 100% Blue
  1279.  
  1280.     White
  1281.           100% Red, 100% Green, 100% Blue
  1282.  
  1283.      If you wish to turn a colour image into 2 colour black and white,
  1284.      greyscale the image first with the greyscale effect, See Show
  1285.      effects.
  1286.  
  1287. Gamma
  1288.      Adjusting the gamma of an image has the effect of lightening some
  1289.      of the mid-dark colours, whilst leaving the dark colours dark.
  1290.      This can often enhance the eye's perception of the image, as the
  1291.      eye is more responsive to light colours. Gamma correction can also
  1292.      be useful when printing an image out, as mid-dark colours tend to
  1293.      get printed too dark.
  1294.  
  1295.      Only small alterations are usually needed with this operator (-20%
  1296.      to +20%).
  1297.  
  1298. Show effects
  1299. ------------
  1300.  
  1301.    Opens / closes the effects floating palette.
  1302.  
  1303.    The effects floating palette contains a list of ImageStudio's built
  1304. in effects. Not all types of effect can be applied to all types of
  1305. buffer, the details are given below. Any numerical values required by
  1306. the individual effects are set using the slider on the effect floating
  1307. palette.
  1308.  
  1309. Dynamic range
  1310.      Cannot be applied to regions of a colour-mapped images.  Expands
  1311.      the dynamic range of the image to the maximum possible, without
  1312.      altering the colour balance. This is useful for automatically
  1313.      increasing the contrast of poor contrast images, e.g. the output
  1314.      from a scanner.
  1315.  
  1316. FlipX
  1317.      Can be applied to all types of image.  Flips the whole image or
  1318.      selected region horizontally.
  1319.  
  1320. FlipY
  1321.      Can be applied to all types of image.  Flips the whole image or
  1322.      selected region vertically.
  1323.  
  1324. Greyscale
  1325.      Cannot be applied to regions of a colour-mapped images.  Reduces a
  1326.      colour image to a greyscale image. The actual greyscale values (or
  1327.      more correctly, luminosity) value is calculated as 30% of the red
  1328.      component + 59% of the green component + 11% of the blue component.
  1329.  
  1330. Highlight
  1331.      Cannot be applied to regions of a colour-mapped images.  Turns all
  1332.      colours with greater than the given luminance value to white.
  1333.  
  1334. Negative
  1335.      Cannot be applied to regions of a colour-mapped images.  Negates
  1336.      the colour values of the image.
  1337.  
  1338. RollX
  1339.      Can be applied to all types of image.  Rolls the whole image or
  1340.      selected region horizontally, wrapping the image around.
  1341.  
  1342. RollY
  1343.      Can be applied to all types of image.  Rolls the whole image or
  1344.      selected region vertically, wrapping the image around.
  1345.  
  1346. Pixelize
  1347.      Can be applied to all types of image.  Replaces all pixels in the
  1348.      whole image or selected region with larger pixels. The new pixel
  1349.      size is taken from the slider.
  1350.  
  1351. Random
  1352.      Cannot be applied to colour-mapped images.  Adds random noise to
  1353.      the image. The greater the random value, the greater the noise.
  1354.  
  1355. Remove isolated pixels
  1356.      Can be applied to all types of image.  Removes any single pixels
  1357.      that are a different colour to their neighbours. Useful in
  1358.      removing some of the noise in black and white scans.
  1359.  
  1360. Shadow
  1361.      Cannot be applied to regions of a colour-mapped images.  Turns all
  1362.      colours with less than the given luminance value to black.
  1363.  
  1364. Show convolves
  1365. --------------
  1366.  
  1367.    Opens / closes the convolves floating palette.
  1368.  
  1369.    The convolves floating palette allows the user to apply their own
  1370. convolution effects to a 24-bit image; convolution will not work on
  1371. colour-mapped images. For an explanation of how convolution works, See
  1372. Convolve presets.
  1373.  
  1374.    To create a new convolution filter, select `New' and then `Edit'
  1375. from the floating palette. The convolve grid requester contains the
  1376. convolution filter's name at the top as well as gadgets for the filter,
  1377. divisor and bias values. When the user has set the filter values, click
  1378. on `OK' to return to the convolve floating palette.
  1379.  
  1380.    To apply a filter, select it in the listview and click on `Apply'.
  1381. To delete a filter from the list, click on `Del'. This will not delete
  1382. the file from the disk, this has to be done from the Workbench.
  1383.  
  1384.    To scan a new drawer for convolution filters, click on `Load' and
  1385. select a directory to scan. To save the current list's convolution
  1386. filters, click on `Save' and select a drawer to save to.
  1387.  
  1388.    The default drawer to scan at startup is set in the preferences, See
  1389. Prefs.
  1390.  
  1391. Reference
  1392. *********
  1393.  
  1394.    This chapter gives detailed explanations about various aspects of
  1395. the program.
  1396.  
  1397. File formats
  1398. ============
  1399.  
  1400.    Select the file format you wish to investigate.
  1401.  
  1402. IFF-ILBM
  1403. --------
  1404.  
  1405.    IFF-ILBM is the Amiga's native bitmap graphic file format.
  1406.  
  1407.    IFF-ILBM covers both colour-mapped (palette based) images, true
  1408. 24-bit and hold-and-modify (HAM8) colour modes.
  1409.  
  1410.    IFF-ILBM files are usually compressed using simple run-length
  1411. compression, but they can be uncompressed for simplicity and speed.
  1412.  
  1413. Loads:
  1414.         - Compressed (cmpByteRun) and uncompressed IFF-ILBM files.
  1415.  
  1416.         - Colour-mapped (palette based) images upto 256 colours.
  1417.  
  1418.         - HAM6 and HAM8 images.
  1419.  
  1420.         - Extra half-bright images.
  1421.  
  1422.         - ILBM24 24-bit images.
  1423.  
  1424. Saves:
  1425.         - Compressed (cmpByteRun) and uncompressed IFF-ILBM files.
  1426.  
  1427.         - Colour-mapped (palette based) images upto 256 colours.
  1428.  
  1429.         - HAM6 and HAM8 images.
  1430.  
  1431.         - Extra half-bright images.
  1432.  
  1433.         - ILBM24 24-bit images.
  1434.  
  1435.    Note:
  1436.  
  1437.    * ImageStudio will load and save AGA images on a non-AGA machine.
  1438.  
  1439.    * The original image's screenmode will be preserved, unless changed
  1440.      by the user (see View screenmode).
  1441.  
  1442. BMP
  1443. ---
  1444.  
  1445.    BMP files are commonly found on PCs running Microsoft Windows.
  1446.  
  1447.    BMP images can be both colour-mapped (palette based) or true 24-bit
  1448. colour.
  1449.  
  1450.    BMP images are usually uncompressed and come in 2 flavours -
  1451. `Windows' and `OS/2'.
  1452.  
  1453. Loads:
  1454.         - Windows and OS/2 formatted uncompressed images.
  1455.  
  1456.         - Colour-mapped (palette based) images upto 256 colours.
  1457.  
  1458.         - 24-bit colour images.
  1459.  
  1460. Saves:
  1461.         - Windows formatted uncompressed images.
  1462.  
  1463.         - Colour-mapped (palette based) images upto 256 colours.
  1464.  
  1465.         - 24-bit colour images.
  1466.  
  1467. EPS
  1468. ---
  1469.  
  1470.    EPS files are ASCII text files written in the PostScript language.
  1471. They can be printed out directly to a PostScript printer or imported
  1472. into word processing or DTP packages.
  1473.  
  1474.    EPS files are an ineffecient method of storing files, as they are
  1475. uncompressed and are stored as ASCII text as opposed to binary data.
  1476. Unless colour is specifically required it is recommended that EPS files
  1477. be saved in the greyscale format, as they are one third of the size of
  1478. a colour EPS file.
  1479.  
  1480.    EPS import is not supported.
  1481.  
  1482. Saves:
  1483.         - Colour mapped or 24bit colour images.
  1484.  
  1485.         - Greyscale or colour.
  1486.  
  1487. GIF
  1488. ---
  1489.  
  1490.    GIF is a common format for images upto 256 colours.
  1491.  
  1492.    GIF is a trademark of Compuserve Incorporated.
  1493.  
  1494.    GIF images are normally smaller than their equivalent IFF-ILBM
  1495. counterparts due to GIF's LZW compression algorithm. GIF files are
  1496. always compressed.
  1497.  
  1498.    GIF comes in 2 flavours - `GIF87a' and `GIF89a'. GIF87a is the most
  1499. popular format; ImageStudio should load in both GIF87a and GIF89a
  1500. although the latter is untested as we couldn't find any genuine GIF89a
  1501. files.
  1502.  
  1503. Loads:
  1504.         - GIF87a and GIF89a (see above) format images.
  1505.  
  1506.         - Colour-mapped (palette based) images upto 256 colours.
  1507.  
  1508. Saves:
  1509.         - GIF87a format images.
  1510.  
  1511.         - Colour-mapped (palette based) images upto 256 colours.
  1512.  
  1513. JPEG
  1514. ----
  1515.  
  1516.    JPEG is a powerful format for storing images as 24-bits.
  1517.  
  1518.    JPEG allows the storage of 24-bit images as very small files due to
  1519. its lossy compression algorithm. Whereas the compression algorithms
  1520. used by other file formats loose none of the image information, JPEG
  1521. trades off a little loss in image quality for a high degree of
  1522. compression.
  1523.  
  1524.    In order to select the degree of image quality, select the `Options
  1525. choose' from the `Save' requester (see Save). A quality value of 75 is
  1526. given by default, resulting in an acceptable degredation of image
  1527. quality. For higher degree of compression choose a lower value(1). For
  1528. a higher degree of quality, choose a higher value; values of 85 to 90
  1529. result in an almost unnoticable loss of quality.
  1530.  
  1531.    The image can also be saved in a greyscale format, where the colour
  1532. information is lost but the output file size is correspondingly smaller.
  1533.  
  1534. Loads:
  1535.         - JPEG / JFIF format images.
  1536.  
  1537.         - Greyscale and 24-bit images.
  1538.  
  1539. Saves:
  1540.         - JPEG / JFIF format images.
  1541.  
  1542.         - Greyscale and 24-bit images.
  1543.  
  1544.    As JPEG is a relatively new format, an exact format of the JPEG file
  1545. was only agreed on recently. This format is called `JFIF' and these are
  1546. the most commonly used JPEG format files - and the format that
  1547. ImageStudio loads and saves. It is highly unlikely that any old JPEG
  1548. files are still being circulated, but should you find one it is
  1549. uncertain whether ImageStudio would accept it.
  1550.  
  1551.    A high degree of compatibility is obtained with our JPEG loader /
  1552. saver routines, as they are based in part on the work of the
  1553. Independant JPEG group's routines.
  1554.  
  1555.    ---------- Footnotes ----------
  1556.  
  1557.    (1)  Values less than 25 may cause problems with some JPEG readers
  1558.  
  1559. PCX
  1560. ---
  1561.  
  1562.    PCX files are commonly found on PCs running Microsoft Windows.
  1563.  
  1564.    PCX images can be both colour-mapped (palette based) or true 24-bit
  1565. colour. PCX files are always compressed using a very inefficient
  1566. run-length encoding algorithm. This algorithm can, in some cases, lead
  1567. to an increase in file size over an uncompressed image. PCX is included
  1568. in ImageStudio for compatibility with other platforms, but we do not
  1569. recommend the general storing of images in this format.
  1570.  
  1571. Loads:
  1572.         - Colour-mapped (palette based) images with 2 - 16 colours.
  1573.  
  1574.         - Colour-mapped (palette based) with 256 colours.
  1575.  
  1576.         - 24-bit colour images.
  1577.  
  1578. Saves:
  1579.         - Colour-mapped (palette based) with 256 colours.
  1580.  
  1581.         - 24-bit colour images.
  1582.  
  1583. Targa
  1584. -----
  1585.  
  1586.    Targa is an established colour-mapped and 24-bit colour format used
  1587. on the PC.
  1588.  
  1589.    Targa is usually used for storing 24-bit images, although it can
  1590. also handle colour-mapped images as well. The data is usually stored as
  1591. simple uncompressed data, however it can also be run-length encoded to
  1592. allow compression.
  1593.  
  1594. Loads:
  1595.         - Uncompressed / compressed Targa format.
  1596.  
  1597.         - Colour-mapped (2 colour, 256 colour).
  1598.  
  1599.         - 15, 16, 24 and 32-bit true colour images.
  1600.  
  1601. Saves:
  1602.         - Uncompressed Targa format.
  1603.  
  1604.         - 256 colour-mapped images.
  1605.  
  1606.         - 24-bit colour images.
  1607.  
  1608. Image types
  1609. ===========
  1610.  
  1611.    ImageStudio works internally with either "colour-mapped" or "24-bit"
  1612. images. A description of the workings of both methods follows.
  1613.  
  1614. Colour-mapped images
  1615.      Colour-mapped (palette based) images are used by the standard
  1616.      (non-HAM) screenmodes on the Amiga. A set of colours (palette) is
  1617.      chosen for the image and every pixel in the image can have one of
  1618.      these colours.
  1619.  
  1620.      Colour-mapped images have the advantage of being a fairly compact
  1621.      way of storing image information and with a large palette (greater
  1622.      than 64 colours) high quality images can be produced. They have
  1623.      the disadvantage that the colours in the image are limited to the
  1624.      colours in the palette - with a small palette it becomes a complex
  1625.      task choosing the correct colours to best portray the image.
  1626.  
  1627. 24-bit images
  1628.      24-bit images allow every pixel in the image to be an individual
  1629.      colour - this is essential for high quality images.
  1630.  
  1631.      24-bit images have the disadvantage that they are typically at
  1632.      least 3-times larger than colour-mapped images and require
  1633.      sophisticated display hardware to show them in their true glory.
  1634.  
  1635. When should I use each type of image?
  1636.      In general, try to leave the image in the format in which it came.
  1637.      If, for example, you load in a colour-mapped image try and perform
  1638.      all your operations directly to the colour-mapped image; only
  1639.      change to a 24-bit image if absolutely necessary (e.g. to apply a
  1640.      convolution filter).
  1641.  
  1642. Colour representations
  1643. ======================
  1644.  
  1645.        ImageStudio works internally with the R,G,B format of colour
  1646. representation. This is the most common method of storing colour
  1647. information on computers, as it represents the amounts of intensities
  1648. applied to the 3 colour guns of a computer monitor.
  1649.  
  1650.        H,S,V stands for Hue, Saturation and Value. The hue is the basic
  1651. colour (e.g. red, yellow, green, purple etc...), saturation is the
  1652. amount of that colour (e.g. weak red, strong red etc...) and the value
  1653. is the brightness of the colour.
  1654.  
  1655. Tooltypes
  1656. =========
  1657.  
  1658.    ImageStudio supports the configuring of the program via tooltypes
  1659. from either the Workbench or CLI.
  1660.  
  1661.    It is recommended that the user who starts the program from
  1662. Workbench uses the "Prefs" requester of ImageStudio to configure it
  1663. (see Prefs), whereas the CLI user should be aware of the tooltype
  1664. options.
  1665.  
  1666.    Possible options for a tooltype value are shown with a bar `|'
  1667. character (read as `or'). Numerical values are shown as `<value>',
  1668. string values as `<string>'.
  1669.  
  1670. `CONVOLVE=YES | NO'
  1671.      Whether the convolve floating palette should be open at startup.
  1672.  
  1673. `CONVOLVETOP=<value>'
  1674.      The top position to open the convolve floating palette.
  1675.  
  1676. `CONVOLVELEFT=<value>'
  1677.      The left position to open the convolve floating palette.
  1678.  
  1679. `EFFECT=YES | NO'
  1680.      Whether the effect floating palette should be open at startup.
  1681.  
  1682. `EFFECTTOP=<value>'
  1683.      The top position to open the effect floating palette.
  1684.  
  1685. `EFFECTLEFT=<value>'
  1686.      The left position to open the effect floating palette.
  1687.  
  1688. `BALANCE=YES | NO'
  1689.      Whether the balance floating palette should be open at startup.
  1690.  
  1691. `BALANCETOP=<value>'
  1692.      The top position to open the balance floating palette.
  1693.  
  1694. `BALANCELEFT=<value>'
  1695.      The left position to open the balance floating palette.
  1696.  
  1697. `PREVIEWTOP=<value>'
  1698.      The top position to open the preview window.
  1699.  
  1700. `PREVIEWLEFT=<value>'
  1701.      The left position to open the preview window.
  1702.  
  1703. `PREVIEWWIDTH=<value>'
  1704.      The width of the preview window.
  1705.  
  1706. `PREVIEWHEIGHT=<value>'
  1707.      The height of the preview window.
  1708.  
  1709. `SCREENMODEID=<value>'
  1710.      The screenmode to open the ImageStudio screen.
  1711.  
  1712. `SCREENOVERSCAN=TEXT | STANDARD | MAX | VIDEO'
  1713.      The overscan to be used on the ImageStudio screen.
  1714.  
  1715. `SCREENDEPTH=<value>'
  1716.      The depth in bitplanes of the ImageStudio screen.
  1717.  
  1718. `SCREENWIDTH=<value>'
  1719.      The width of the ImageStudio screen.
  1720.  
  1721. `SCREENHEIGHT=<value>'
  1722.      The height of the ImageStudio screen.
  1723.  
  1724. `TEMPDIR=<string>'
  1725.      The location on hard disk to store the virtual memory temporary
  1726.      files.
  1727.  
  1728. `CONVOLVEDIR=<string>'
  1729.      The drawer to read for the covolution filters.
  1730.  
  1731. `PALETTEDIR=<string>'
  1732.      The drawer to read for palettes.
  1733.  
  1734. `PAGESIZE=<value>'
  1735.      The size, in kilobytes, of the virtul memory pages.
  1736.  
  1737. `CLIPUNIT=<value>'
  1738.      The system clipboard unit to use.
  1739.  
  1740. `EXTERNALVIEWER=<string>'
  1741.      The CLI command to execute to run the external 24-bit viewer.
  1742.  
  1743. `UNDOBUFFERS=<value>'
  1744.      The number of levels of undo / redo available.
  1745.  
  1746. `PREVIEWDITHER=YES | NO'
  1747.      Whether to perform dithering on the greyscale preview window.
  1748.  
  1749. `SPLASHWINDOW=YES | NO'
  1750.      Whether to open the `About' window at startup.
  1751.  
  1752. Known bugs
  1753. ==========
  1754.  
  1755.    Known bugs:
  1756.  
  1757.    * When changing the screenmode of the ImageStudio program (see
  1758.      Screen mode), the menus are not properly laid out for 2-colour
  1759.      modes. We don't know the reason why, as we re-layout the menus
  1760.      after changing the screenmode. The menus are correctly laid out if
  1761.      the program is started in a 2-colour mode.
  1762.  
  1763.    * At the moment ImageStudio doesn't handle IFF-ILBM files with an
  1764.      interleaved stencil. Make sure when saving from an paint package
  1765.      that the stencil is turned off.
  1766.  
  1767.    * When using the ASL screenmode requester, redraw messages are lost
  1768.      when the requester is moved to "damage" another window. This will
  1769.      be fixed when we sort out how to use the new v38 hook functions.
  1770.  
  1771. Problems with datatypes
  1772. =======================
  1773.  
  1774.    If ImageStudio is running on a Workbench 2.1+ Amiga it will utilise
  1775. the built in datatypes for image conversion; the user should be made
  1776. aware of differences between the datatypes and the built-in ImageStudio
  1777. loaders.
  1778.  
  1779.    The datatypes are only used as a "last resort" if the ImageStudio
  1780. loaders fail to recognise the incoming image. Datatypes have the
  1781. following disadvantages:
  1782.  
  1783.    * The do not utilize virtual memory. Therefore when loading a large
  1784.      image, large amounts of RAM are required.
  1785.  
  1786.    * They can be slow. The datatype first has to convert the image to
  1787.      IFF-ILBM, which ImageStudio has to read in and convert to its own
  1788.      internal format.
  1789.  
  1790.    * Datatypes convert the image to a colour-mapped image. 24-bit image
  1791.      formats (e.g. JPEG) therefore are reduced in quality.
  1792.  
  1793.    * Some datatypes we have tried are fundementally bugged - crashing
  1794.      with odd sized images or different file layouts. ImageStudio has
  1795.      no control over the quality of the installed datatypes.
  1796.  
  1797.    Datatypes though can be useful to load in image formats not yet
  1798. supported by ImageStudio, and are therefore made available to the user.
  1799.  
  1800. Common questions
  1801. ****************
  1802.  
  1803.    If you have any questions about ImageStudio, make sure that it
  1804. hasn't already been answered below:
  1805.  
  1806. Why doesn't ImageStudio support the TIFF image format?
  1807.      TIFF is a powerful and flexible image format, but that is also its
  1808.      downfall. TIFF supports so many compression algorithms, for
  1809.      example, that it would require a very large amount of code to deal
  1810.      with even a modest range of TIFF files.
  1811.  
  1812.      TIFF could well get added later if the loader / savers become
  1813.      external modules, but there is more important work to be done in
  1814.      the meantime.
  1815.  
  1816. Will you be adding support for SHAM, HAM-E, etc...
  1817.      At the moment we have no plans to add sliced HAM, HAM-E or other
  1818.      minority IFF formats. Doing so would increase the program size
  1819.      whilst only catering for a very small number of users. As with
  1820.      TIFF, if the loaders / savers become external modules we could add
  1821.      them then.
  1822.  
  1823. Can I turn virtual memory off?
  1824.      ImageStudio will always work with virtual memory. If you are lucky
  1825.      enough to have lots of RAM and you wish to use that instead of
  1826.      your hard disk, simply put the temp. files in the ram disk (see
  1827.      Prefs). The overhead of using virtual memory from RAM is
  1828.      negligible.
  1829.  
  1830. Why is there not a colour preview window?
  1831.      Even with a relatively small amount of greyscales, a good
  1832.      approximation of the image can be obtained (balance, contrast,
  1833.      etc...). With a small number of colours, a poor representation of
  1834.      the image is the result. A greyscale preview is also faster.
  1835.  
  1836. Why have I only got one method of colour choice?
  1837.      Under versions of ImageStudio before 1.1.0, three methods of
  1838.      colour choice were given. This algorithm was limited in its
  1839.      accuracy for chosing colours, we therefore provided the user with
  1840.      the different methods to aid its colour choice. From
  1841.      ImageStudio-1.1.0 the accuracy has been greatly increased, thus
  1842.      removing the need for the user interaction.
  1843.  
  1844.      The cycle gadget is kept incase we decide to implement another
  1845.      method of colour choice instead of the Heckbert median cut
  1846.      algorithm.
  1847.  
  1848. Why do the preview window colours change when I use the `Palette Edit' requester?
  1849.      In order to display the colours in the image, we have to use some
  1850.      of the screen colours. These colours are usually the greyshades in
  1851.      the preview window, and so it is these colours that will also
  1852.      change. *This is not a representation of what is happening to the
  1853.      image!*
  1854.  
  1855. Why don't you rewrite parts of the program in assembler for speed?
  1856.      As we have progressed through the versions, we have replaced and
  1857.      rewritten many of slower routines with faster and more efficient
  1858.      algorithms. The reason for the lack of speed in some of the
  1859.      earlier routines was not due to the choice of language (`C'), but
  1860.      the choice of algorithm. Now that we have more efficient
  1861.      algorithms throughout, re-writing portions in assembler would
  1862.      probably only yeald minor speed increases. We feel that time spent
  1863.      squeezing another 10% speed increase is probably better spent
  1864.      developing a new feature.
  1865.  
  1866. What other programs have the authors written?
  1867.      Andy has written "StickIt" - an Amiga equivalent of the `PostIt'
  1868.      note; useful for reminding you of things to do.
  1869.  
  1870.      Graham has written "MultiSample" and "MooseDrive". Multisample is
  1871.      a utility for converting to and from common Amiga / PC / Atari ST
  1872.      sound sample formats. MooseDrive is a frantic "viewed from the
  1873.      top" car racing game with multiple large scrolling tracks and the
  1874.      ability to upgrade your car as you win races.
  1875.  
  1876.      All the above programs are available from PD libraries as well as
  1877.      the InterNet's `Aminet' servers.
  1878.  
  1879. The authors
  1880. ***********
  1881.  
  1882.    ImageStudio was written by Andy Dean and Graham Dean.
  1883.  
  1884.    Queries and orders (see How to register) should be sent to Graham at:
  1885.  
  1886.      Graham Dean,
  1887.      14 Fielding Avenue,
  1888.      Poynton,
  1889.      Stockport,
  1890.      Cheshire.
  1891.      SK12 1YX
  1892.      ENGLAND
  1893.  
  1894.    Andy can be reached for queries (no orders) via Internet Email at:
  1895.  
  1896.      adean@eleceng.ucl.ac.uk
  1897.  
  1898.    The rate at which ImageStudio progresses depends on a few things:
  1899.  
  1900.   1. You. If you like and use the program, please register it. If you
  1901.      like the program but think it is missing something that isn't
  1902.      already in our future additions list (see Future additions) *let
  1903.      us know!*.
  1904.  
  1905.   2. Other work. Graham is studying `A' levels and Andy is doing a PhD
  1906.      and this work will take priority (sad, but true).
  1907.  
  1908.    If you find a bug in ImageStudio that is not convered in the `Known
  1909. bugs' list (see Known bugs), inform the authors at the above addresses.
  1910. Be sure to include as much information as possible, the version of
  1911. ImageStudio being used, a description of the Amiga system you are
  1912. running (model, amount of RAM, Workbench version, any expansion cards).
  1913.  
  1914.    If you are having problems loading a particular file into
  1915. ImageStudio, test whether it will load into any another package and if
  1916. possible whether other files created by the same program also give
  1917. problems. We cannot really test every faulty file, but if files created
  1918. by one particular program only give problems on ImageStudio then we'll
  1919. look into that.
  1920.  
  1921. How to register
  1922. ***************
  1923.  
  1924.    To receive the full version of ImageStudio, send 10 pounds sterling
  1925. (20 US dollars overseas) to:
  1926.  
  1927.      Graham Dean,
  1928.      14 Fielding Avenue,
  1929.      Poynton,
  1930.      Stockport,
  1931.      Cheshire.
  1932.      SK12 1YX
  1933.      ENGLAND
  1934.  
  1935.    We will accept the following methods of payment:
  1936.    * 10UK pounds cash.
  1937.  
  1938.    * A 10UK pounds cheque, drawn on a UK bank.
  1939.  
  1940.    * A 10UK pounds postal order, purchased in the UK.
  1941.  
  1942.    * 20US dollars cash.
  1943.  
  1944.    * Eurocheque.
  1945.  
  1946.    * International money order.
  1947.  
  1948.    We *don't* accept any foreign cheques drawn on non-UK banks and we
  1949. *don't* accept any foreign postal orders.
  1950.  
  1951.    Note: Make sure that when sending cash, it is well wrapped in the
  1952. envelope.
  1953.  
  1954.    In return you will receive the full version of the package, complete
  1955. with a 68020+ optimized version of the code for faster convolution and
  1956. dithering. Please allow a resonable time to allow cheque clearance, the
  1957. processing of the order, etc...
  1958.  
  1959.    Upgrades will be offered to registered users free of charge. If you
  1960. live overseas, simply send 2 disks to the above address and you will
  1961. receive the latest version (it's probably best to contact us first to
  1962. find out what the latest version is). UK users should include
  1963. appropriate postage (2 first class stamps are adequate) with their 2
  1964. disks, to cover return postage. In both cases, your packaging will be
  1965. re-used to return the disks.
  1966.  
  1967.    The version number of ImageStudio (see About) is to be interpreted
  1968. as:
  1969.  
  1970.      version.revision.subrevision
  1971.  
  1972.    The `version' shows the main version of the program, `revision' will
  1973. be increased as small additions and improvements are made to the
  1974. program. The `subdivision' value is incremented with bug fixes. All the
  1975. values are simple decimal, not floating point, so version 1.9.0 would
  1976. be followed by version 1.10.0.
  1977.  
  1978.    New versions of the unregistered package will be distributed with
  1979. every change in revision number.
  1980.  
  1981. Credits
  1982. *******
  1983.  
  1984.    The authors would like to thank:
  1985.  
  1986.    * Commodore-Amiga.
  1987.  
  1988.    * Carl Revell and David Cusick, for beta testing ImageStudio.
  1989.  
  1990.    * Matt Dillon, for the `Dice' C compiler.
  1991.  
  1992.    * SAS Institute, for the SAS/C C compiler.
  1993.  
  1994.    * Ian OConner, for `The Designer' - used to do all the GUI windows
  1995.      design.
  1996.  
  1997.    * All the public domain / freeware / shareware authors, for loads of
  1998.      great software.
  1999.  
  2000.    * The Independant JPEG Group, for their essential JPEG code and
  2001.      information.
  2002.  
  2003.    * All those involved with the excellent TeX and `TeXinfo' packages.
  2004.  
  2005.    ImageStudio has been tested on:
  2006.  
  2007.    - A500, Workbench 2.04, 1Mbyte CHIP RAM, 2Mbyte FAST RAM, A590
  2008.      85Mbyte SCSI hard drive, Microbotics VXL*30 accelerator (no 32-bit
  2009.      RAM).
  2010.  
  2011.    - A1200, Workbench 3.0, 2Mbyte CHIP RAM, 4MByte FAST RAM, Power
  2012.      PC1204 expansion card, 68882 FPU, 85Mbyte IDE hard drive.
  2013.  
  2014.    - A4000/EC030, Workbench 3.0, 2Mbyte CHIP RAM, 4MByte FAST RAM,
  2015.      68882 FPU, 130Mbyte + 420Mbyte IDE hard drives.
  2016.  
  2017. Future additions
  2018. ****************
  2019.  
  2020.    The following features will probably be added to future versions of
  2021. the packages (roughly in order):
  2022.  
  2023.    * ARexx.
  2024.  
  2025.    * Allow the reading of corrupt image files (upto the point where
  2026.      they become corrupt).
  2027.  
  2028.    * Halftoning operators.
  2029.  
  2030.    * Image rotation.
  2031.  
  2032.    * Spare buffer.
  2033.  
  2034.    * Alpha channel buffer.
  2035.  
  2036.    * Making the loader / savers external modules.
  2037.  
  2038.    * Aspect ratio correction in the preview window.
  2039.  
  2040.    * AmigaGuide help from the program.
  2041.  
  2042.